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Releasins thepomer to eveiffpne, 

^ding files carrier bunny 

QaiyLitUe,authorof Brady Book's Inside theApple lie, Inside theJ^plelle, 
mi/^ple FroDO&Admnced retitures for Programmers; author of Addison- 
life!>le>''s upcoming Exp(om§ the J^te Ilgs; contributing editor lo A+: and 
author of Knpoinfs PoM'To-PaInt communications pacKage (I was vetj' 
imp^essed^vitll litUc until 1 found out he% also a lawyer), recently developed 
a spedal file format called Binary II, to make Apple II communications 
easier. He has placed the format, as well as two Applesoft programs that 
convert ProDOS flies Into and out of the format In the public domain. If we 
can talk everyone in the Apple II kingdom into usin^this format for programs 
and data they post on bulletin bbardis andin cEWiiiSWM dafe 
be speaking the same language. 

TheApplettUi^doiii needs Binaiy U for coiiimunicatioit5b#aiise|t 
allows all the various types of files we have (FroDOS SYS, BIM, BAS, DIR. AWP; 
DOS 3.3 B, A, and T to name a few) to be easily transfened from one 
computer to another by modem and phone line. In addition to simply 
transferring the data in the flies, it also leaves each flie's attributes {lock/ 
unlock status, flle lypc, filename, creation date, and so on) unchanged. Since 
modem-phone transfers usually take place with the help of a local bulletin 
board or commercial data liase service that doesn't know SYS from SOS, 
Binary II uses a standard binaiy flle format, vrfiich such boandsand services 
can't complain about It also allows programs that require several different 
fifes to be bundled together and transmitted in a single pacKage. 

Until Binaiy II appeared, h:ansfers of Apple II files were usually done by 
converting all other types of fltes into text files. This has been the case even 
though many of the available Apple II communications programs actually 
include protocols for sending flies without doing this, The problem with 
previous protocols was that they were all different from one another. In order 
to use one you had to have the same com munication soflwaie at ea(|6t:^j4 ^ 
the phone Une. This is at least inconvenient and sometiraes> as wli^ ijJiig a, 
commercial data base vendor as an intermediary; impossible. 

The coniisrt-it-to-a-text-fllc method, on the other hand, works, but juSt 
barely It's a pain in the chips for the sender, it usually triples the size of the 
flle, which means more mone^ and time for transmission, and it requires that 
the receiver EXEC or otherwise process the flle to convert it back to its correct 
format Sometimes receivers find they don't have enough information to do 
this. Even when conversion works, other problems arise. For example, 
Appleltorks word processing flies lose their formatting with this procedure. 
And Ifs nearly impossible to send an AppleWDrks spreadsheet file this way. 

LilJie| B3«teBateftcapsulates one or more flies oP^f i|piiffiiHa Blni^ 
11 file. Vi/hen stored on a FroDOS disk, a Binaiy II flle looks like a standard BIM 
file. Any communication software can send or receive this type of file using 
XMODEM or any other transfer protocol. Other operating systems and 
computers think Binaiy II files are standard binaiy files. Binaiy II flies, 
however, always have a name that ends with ".BI^' so that we Apple II people 
can easily recognize one of them on an alien bulletin board, BIW is 
pronounced "bunny" because aftear you bring one home it can quickly 
produce a litter of little flies. 

Eveiy BNY file begins with a l^ft^te "header" that holds all the 
attributes for the firstfiie that has been encapsulated, as wdl as a few bytes of 
information about the BriY file itseifthow manyfiles are in it howmuch disk 
space they require, and so on). After the header you'll find the first flle. If the 
file won'tdrvide into even tZS-byte chunks, bytes holding zeros are added to 
the last chunk until ifs an mn 128 bytes tong. If there isonly one file inside 
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ihie BMK WKff lie endrfteife. fftfieiE are tm^ files, they follow in the 
same order; a header, the file itself, and filler zeros. A BPIY file can even hold 
one or more subdirectories. A BnV file is never more than 511 bytes-per-file 
longer than the original flies. 

To create a BlW file you can use Little's public domain program or version 
151 or higher of Little's Foint-7b-Foint The public domain program asks for 
the names of the FroDOS files you want to encapsulate (they must all be in 
the same subdirectory) and aeates a BflY file that holds all of them. The BMY 
file can then be sent to a host computer. The host unwiti;ing|y stores Uie file 
and allows others to downloadit Those who dottirload can then split the B^IY 
back into exazt duplicates of the original ProDOS files with Littje's second 
public domain program. 

Since Little has placed the Binary II format in the public domain, anybody 
can write a communications program that automatically sends files in BDY 
format and that automatically splits BMY files into duplicates of the original 
files as downtoading progresses. But whether other publishers do this or 
not, you can use any communications software to send and iKeive BMY flies. 
If your software doesn't specifically support BMYs, however, you must use 
Little's public domain programs or the equivalent before sending and after 
receiving 

Little's programs are stored (as text files that can be EXECed into 
Applesoft) in the MAUQ library on CompuServe. Search for the files 
BI2UF.EXE and BI2DWn.EXE. When you EXECtiiese they become BIIIARYUF, 
vrtiich is for wrappingfiles in a BITC and BIMARYDWri, which is for unwrapping 
a BNT^ If you'd like complete documentation on the internal structure of 
Binaiy II flies, also download BIBARldDOC. 

Th^ AppleWorks 2.0 up^ade program is scheduled to end on ^ril 
50, 1987 To upgrade an earlier version, ask your dealer for a special maile r. 
Enclose $50 and your original disks. Apple wiU send you new manuals and 
disks. I shiongly suggest you keep a copy of your earlier version of 
AppleWorks in a safe place — it will do a fewtllii!gs 2,p lan'tdOi asypu'll l^rn 
when you read this month's letters. 




COME ONjMCM. VW DOESlME MOfeE PLUG 
m TO KEVBCW IF VOU'RE NCrr SUPPOSED 
TO use IT UK£ 



S:l8 (^OhAfifta 

Reed a program for teaching physics with Apple lis? Datasheet is a 
very high-quality public domain program that was designed with that in 
mind. 1 recently saw ttie program being used by students and was very 
impressed. It pn)vides a 6<olumn by IBO-row ' spreadsheet" for data entry 
and for statistical analysis (means, standard delations, least squares and 

Tgib tssbomeoii and ca plot bnO^^ m acqiifaed data, am in ml 

iutitadithasajn^vedttietestonieaKyteeliystude^ 

tai>sM oTAppie ns— the State IMversl^cf i^Ycxk at Oeaeseo.fcirmaK 

Inlbnnation about the program contact Kenneth Knsey or Daidd Hdsel, 
DeptofFhysics&AstronomySUriY,Qeneseo,r!y 14454. • 

Polanvare/Penguiii Software hasn't changed the conunadal venicm 
oSTheGnphics nagician hr some time, but they've continued to enhance 
the version that they use in-house and license to software developers. The 
current developer version creates graphics in a special format that makes 
Ihem quickly compatible with and take lull advantage of the strengths (rf 
l»tti standanl and djMtil&hij^ lesotutkfn Apple U formats/ as well as of 
?S«SM^]M^OaiamoS^ Compatibility 



with Apple ligs super high-res is upcoming. Tor more information about the 
developer edition of The Graphics Wagician a)ntact Mark Felczarski at 
Polatware ( Box 311 Geneva, IL 60134 312-232-1984). 

Those of you interested in genealogy mi^t want to check out a $35 
prog-am called Personal Ancestnd fiie published by the Qiutch Jesus 
CtuM of the Latter-day Saints. 1 haaen't actually seen the prajpanb but a 
minlfeviairof ft h the Appleton, ffisonisin user group neMsleSier made it 
sound very interesting Tar more infomiation, call 801-531-2584 and a^ ibr 
an order form. Make sure yoti tell them you're interested In the Apple H 
version of the program. 

Software Piiblishing Corporation, creatora of the PFS series of 
products, is apparently giving up on the Apple II market According to a 
letter that FFS Product Support sent to one of our subscribera in mid- 
Pebraary, "Tlie FTS products have notl)eentestedonthe Apple It is not 
planned to update the products for that machine, or to drop cc^ piotaition 
on tbe cunmtiete^es tf^ progEam." 

nOm^M^im ceasedpnliltcaUoii. 




Ask 

(or tell) 

Uncle 
DOS 



You are encouraged to turn to f!ebniary's page 5. 7, 
pend( In hand, and change the two references to 
P0«£ 47246, one Mf-way down the first column 
and the second near the tap of Hie middle column, to 
POKE 47426. The two and one o/ Hie ftm were 
accltfentaili; transposed. 

Insert system disk and... 

I'm confused by a murky prtd)temMth my Apple He 
and lIgs, and I'm hoping you m^ltt be aMe to shed 
some light on (he cause. 

Wilfa Ifae ;^ple lie I use a PlofQe hard drive. My 
pioblem Is that if I torn cm my modem (a 
Smartmodcml2TO)aflierboodng the Proftle, orlum 
off the modem befcBE laming off the computo-, my 
screen almost ahrays goes to garbage. It shifts to 40 
columns of gibberish a nd at Uie bottom of the sa?,en 
is the message, "Insert system disk and restart— Err 
01". As you can imagine, I've learned to be veiy caieftil 
to tum modem on first and off last It does not 
ha^en cdis^tiEi%iiiidi Is the mostpuzzlinspait 
of EdL 1 think, butam not certain, thatithappensontif 
if] have loaded ASCB fipresst M hi tietcase lit 
happens «iieBier IVe actual^ used fiie modem or 
not 

Recently I added an Apple Ilgs to my collection of 
Apples and I'm suddenly having a similar problem. 
After doing quite a bit of worksuccessfully, I suddenly 
bad dumis middie of saving an ^pleWoiiis 
document the same pntfdem above, wth the 
same enor message. It happasedanoSiartiineiijim 
ISCaping fnom an AppleWort(sdoOiraetttf}3dlfotfie 
main menu. ! lost the documents both times. Before I 
got my 3.5 drive for the ^ I was using Appletttorks 
successfully from a 3.25 dllve with ^iDC^ IX and 
had no pnablems. 

I'm suspecting there is some probfem with interrupts, 
but in one case I'm using ProDOS U and a modem, in 



the other case FidDOS 8 with a clock. Do you or your 
subscribers have any dlagnoseSv suggcslini^ or 
sdi^ons? 

CLRoberts 
t,afayette, Calif. 

/ suspect interrupts, ioo. / think the problems you 
mention with the ilgs are thp more serious ones and 
/ can confinn that they are real — they've happened 
toiiMV(BQbf$B^]ectmorepeopJe aren't complaining 
afmpfy teciuse ounsU i»i^cn$ o/.^^^ 

dfjPhciQOS&fiol^ indisablesintemi^ftOD0& 
6 does RDt Ihenasain, msybe you mdlmeOte oniy 
two people biOuUnMu^hmeiqtettmxdlltb 
strange beftatilor. 

One soiution is to stick with FroDOS 111 On the 
Ilgs, hoftieuer, this means you lose the ctodt. A 
second solution Is to use the neuier uersions of 
ProDOS on the XT^ J>Mt imm0U disaiile irOar^^ 
nils means you lose Oe >30i^pmti (imlBssyou 
temporarflj/ tum Interrupts back on before piesslng 
control/optn-apple/escape). You aiso lose Apptetalk 
and some other HQS features. Consequently. dLsabiing 
mferrupts can't t>e a permanent solufiop!, but I think 
it will he heipfut while Apple comes to gr!p.s with the 
{act thai U has a proi^m wiUi interrupts and comes 
up um$ilx>iahtilB^4o^utiLmiou^thBWG^ 
num^mceaaor and Ks praigerqj fiaoe abusp^sip' 
ported biempts, Apple N ftnmem mi tp^^)^ 
systems have a kmg Mstory of Ifltem^^fefeifed 
tugs. 

There is simply no reason PmDOS should bomb 
the whole system in response to an unciaimed 
inferrupt. It would t>e much more reasonable to let 
the user know that an unciaimed interrupt occurred 
and (hen to ea^bm trucldng. If such Interrupts 
epfif^iie to occurthe teershotddhaDe Oie QptipnQf 
^mngb^TTuptssoO^warkcaRbesweilmet 
can be pressed, and (he sjfstem restarted. Nost 
undaimed interruf^ are odd, one-time affairs, such 
as the interrupt you're getting lohen you tum your 
modem on or off. To destroy a user's work in 
response lo sometWng iifce this is al3so(uteIy user- 
tostile and not the kind of treatment users hsue 
ameto expect from^^ Ba. 

me resf of Usi tbb-miot bosome more awm of 

interrupts and more careful not to change the 
miCToprocessor's inlemipt status acddentally. ft>r 
example, on a Ugs tum interrupts off and press 
control/open-appte/est^pe. Then proceed to use 
ywroomputer. f/thecontrotpanel suddenly appears 
ft means (fie prosram ou are runnir^ust fumed on 



interrupts. I've found several that do so for no 
apparent reason. 

Here's a coupJc o/ short programs you can use to 
change the internet status of your computer until 
A^gi^PtWOS'sre^ametowiibimed biterrupis 
^miiDdeteVHe40fimbMi4ttiem Vym don't 
use a program selector aticfi as FroSA 
BtiterB^ orSquM. 

IS TEXT : HOC : V1tfl8 12 

n PRINT 'Olsablinq InttmvU.* 

30 PDKC 7C8.1» : PUCE 769.96 : CflU. 7aS 

« PRINT CHM(4);'B''E' 

le TEXT ; mZ : VTfiB 12 

28 PRINT 'Enabling Interrupts.' 

39 POKE ?6B,Ba : POKE 7S9,9S : CflU 7S8 

« PRINT CHRS(4);-BVE- 

Another j)oasU)i% usIng^^ppteHtHjiai on the tigs 
myhavB, Uto use MftrttKivMSilm. tmmg Its 

mmy other /'eahires, it giues Appfeffiorfcs 2.0 the 
ability to recouer from a contnai-reset. Control-reset 
will recover your Apple from the unciaimed interrupt 
error and has the additional beneficial effect of 
turning off most intemipdng deoices. 

Hfith AppleWorks L3 you can use the rescue 
routinefmmtheJune IddGOpen-App/e (pagelSS 
qjterpiessbtsoanfnil-feset. UutrtgLe^endsSci^wwe 

mmse st san di^o, ca asm, m-m- 

3722} sells a simitar routine on disk that can he 
permanently placed on your AppteHbrite dls^c and 
run automaflcaJly, It s called FESET.SYSmi—seBmi 
of our subscribers haue recommended (L 

AppleWorte phone dialer 

Here's a simpieAppteWorks database report format 
you can use b) automatically dial phone numbers, 
assmning ym Imie a modem that wll re^Kind to 
AScn cmmiand Striii^ This usually meats aa 
external, rather than a slot-resident modem. 

The Rrst step is to tell AppleWbrits you have a 
"printer" in the slot that holds the serial card for your 
modem. Do this in the usual manner— from the Main 
Menu select "Other Activities,"' then "^lecily Infomiation 
About Your Printer," then "Add a Printer," then select 
any of the listed printers, such as the ImageWiteL 
Qive it a useliil name such as "modem," or "da^ or 
^&ai phone." Specify (he slot your modemikgonteCtBd 
to. At the next menu all Uiat needs to be changed is 
the code for "Interface cards." Change that code to 
"none " by simply pressing shift'6 (liie catet} to (nd 
the code-input sequence. 

Secondly create a database tile tliatholds your list 
of phone numbers. This list should have separate 
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categories for name, area code, and phone number. It 
could have any additional categories you desire. You 
have to separate the area code from the rest of the 
number to make it easy to dial locally 

The third and final step is to create three report 
fbtnKrts tftatisdll be used to actaally "prinr phone 
numbers to tfie modem and cause It to dial the 
phone. The fiist will be used for long distance calls 
outside your area code, the second for long distance 
calls within your area code, and the third for local 
calls, 

Use the "labels" format for all three of these reports. 
First create a new labels-type report and call it "dial 
other area," Using open-appie-0(ptions), change the 
Paper Length to 1 inch, g^ rid (rf ftie report header 
(PH), arid tell ^^eWorlis you want to send Special 
Codes to the printer (SC). Then enter the codes 
"ATDTl" for touditone or "ATDn" for pulse dialing, 
ESCape out of options and use open-apple-arrows to 
move the area code and phone number to the top line 
of the report You should open-apple-D{elete) most of 
the other categories and blank lines, but I've found it 
useful to display at least one other category, such as 
rtoe> on the line below the line with the phone 
number. The carriatje return at the end of tlie first line 
should keep any istray numbers in one bf fheseeiia 
categories from Ixing dialed, but if you reach Khaddafy 
vhen hying to call your mother, you may have to 
delete the extra categories. 

Mow ESCape bach to the "report menu" and chose 
Item four, "Duplicate an existing format" flame the 
next report format "dial this area." Delete the area 
cctfic cafegoiy from this format. Use this format for 
long distance calls within your own area code. 

Again ESCape back to the "report menu" and 
duplicate the "dial this area" report format Mame the 
duplicate "dial locally" The only change you need to 
make is to remove the "1" fiom the Special Codes in 
open-apple-O(ptions), leaving ATDF or ATDI That is 
the end of the creation ptoc^i 

To actually diala number wiiile using AppleWorks, 
open-appie-QCuids thange) to your phone number 
database, open-appl&-F(rlnt), choose the appfopriate 
dialing format and use open-apple^R(ecord selection) 
to choose a specific number to be dialed. Usually "1 
Mame, 7. Contains" is enough, but you may have to 
"and" that wi1it something else in order to get just 
one record. 

Once you have a record selected, open-apple- 
ZfoomJ so thatyou can check that it's the right one. 
You can use opcn-apple-land q}ei?ft[$le-9 to make 
sure that only one record has been selected. From 
there, press open-apple-F(rint), choose the printer 
called "dial phone" or whatever and print 1 copy 

When the dialed phone starts ringing, pick up your 
receiver and open-apple-P(rint) the phone number a 
second time.This second printing gets the modem to 
hangup. 

Jim Hercules 
JoiinstdMi Ohio 

Wow! It works as aduertised. 

There's one small problem that might crop up on 
the Apple Wgs or offier machines that have a disk 
deoicc, as well as a modem, that appears to be 
connected to slot 2 {this happens automatfcaUy on 
the ligs when mare than two devices are conneded 
to the sfot 5 SmartportJ. ylccording to Steve Stephen- 
son, author of Checkmate Tbchnotogies'J^pleWorks 
expansion software, AppleWorks won't recognize a 
printer if it is assigned to the same slot as a disk 
device. Thus a stot-2 modem may be tnaccessiWe 
framJippieWo^ks m the llgs, even though 



Basicsystem would have no problem with both a 
modem and a disk device "in " slot 2. 

I'm especiaily impressed ujith your open-apple- 
Z(oom) and open-apple-l through -9 trick. 1 hadn't 
previously noticed £tet those commands work on 

Another way to make a dialer would be to create 
just one "dial phone" report format Embed ATDF or 
ATDT within its Special Codes and put ail the other 
required ''dial strokes " in a special category in each 
record. This requires duplicated information in each 
record, butsimpli/ies the caiJing process, 

ft also aitotus you to use long distance companies 
that require access codes. Around here, for example, 
we. make long distance eails by first calling a local 
seeen-di0t number, then entering a six-digjtaisms: 
code, then entering the fen-digit phone tfrnbtflM 
want. These 23-diglt calls are parttculariy fun to 
automate. However, the Special Codes section of 
open-appie-0(ptlons) accepts only 13 characters, 
which isn't enough for the 'AT' code and the long 
distance company's local number and access code. 

Instead, 1 tried putting all 23 digits in a speciai 
cafegofj; caiied "diai sfrofces."it was also necessary 
toadda muflle o/corarnas tefweef} tfii^l 
mmpany'S phone numfcer and ife' sMgff access 
code. These commas make the modem pause, 
which gives the long distance company time to 
ansu«r the phone t)e/orej^te(forfffis^ajfc jpjajchihg: 
in the access code. 

The next step, of course, is to wrSh some macros 
that automate the whole calling process. Soiid- 
option-J^ could can your mother, sdld-oiitsmrS your 
boss, and sdHd-option-L Dgn Lancaster's free Apple 
helpUne (602428-4073). 

In using the AppleWorks database for genealogy, I 
have found that AppleWorks will not accept a year 
ending in 00 in a "date" field If I change the "Date" 
field to "Dte" it will accept everything, but without the 
automatic date procedure. The automatic dating 
procedure is really great except for that little hitch. 

Another problem I've encountercd occurs when 
more than 15 categories toe.l}«pii:.deleted from a 
nejjort feirroat If yoa then hy to leiuseit a category, 
fM tie seleclkws for "insert a line above the 
cursor" and Insert a line below the cursor" actually 
run off the right side of screen. What's worse, if you 
move the cursor to either of these choices the 
program hangs and the only way out is rebooting. 

This does not diminish nor detract ftom Appleltorks, 
I love it and use it every day for everything. 

One idea I've foundiisefiil Is to create a "MBR" field 
M-lte 8)Stcategoiy ofB6«ryfti-'and ase It to assign 
eachreEord a unique number beginning with lOOOl I 
find using this category to select specific records 
really saves time and fi'ustration compared to using 
the name of a person or place or whatever. 

Another idea I've used effectively is to create two 
fields foT addresses, one for the house number and 
one for the street By sorting them both I end up uiti a 
file in the correct logical order. Similarly ray genedogy 
flic has a lot of Thorabur^, Since Af^IeWbrhs win 
only soil on either the first or the last name, I 
transferred all the Thomburgs to a temporary file, 
sorted the first names, and then reinserted the 
Thomburgs into my original file and had all the 
nam^fn firstnameandfestname order properly, 

Jim Thomburg 
AJexandrit,\fe> 



Mft a second, you're doing more luorft than you 
haue to. Altho ugh AppIeHbrlcs will only sort one field 
at a time, you can do what other programs call 
"muUi-key sorts" by sorting all the fields you are 
mterested in, one-at-a-time, in (east-important to 
■m^kipomM. order. For example, first sort: house 
numtera, thenstreef names. Or first sort just names, 
then last names. The iast sort you do is the primary 
sort and, for etampie, alJ your Thomburgs will 
appear together. Within the Thomburgs, however, 
records will be arranged the way they were by tiis 
previous sort —first names in this case. 

I hadn"t noticed AppleWork"s Inability to accept a 
year ending in double zeros be/ore. That will ite a 
ma/or probierr! reaf soon now / don't thinfe changing 
the name of the category Is a good /inal solution 
f>eGaHse then you lose the ability to dochronoiogica! 
sorts. How do you handle dates before 1900? ft 
seems to me thatAppleWork's tu>o-digit years ujould 
be problematical ingeneaJogical applications, 

lhave encountered the problem ujith^^ppleHfarfcs 
hanging when you try to 'insert a blank line in a 
labels-style report format. This bug has been faced in 
Ap^eWbrks 2.0. If you use an earlier uerston of 
ylpirfefWdl. tj|. to remember to sam. your work 
before moSififittg report formats, if ym shouts 
encounter the bug with unsaved work on the desWop, 
press control-reset and see the last paragraph of the 



RowtOdl^nglohde 

[ have a large spreadsheet in AppleWorks, When I 
was developing it I got a message that some cells 
were lost in one row. After saving the file and hying to 
read it later, 1 now get a message from AppleWorks 
that it is getting errors hying to read the file. 

What would cause such problems and how can 1 

IBCBVEf fltefil^? „ „ „ 

William C. Fiquette 

La Junta, rx)lo. 

TTianJcs to a letter from subscriber Pete Johnson, 
we can tell you exiuily how to duplicate this error. 

Using AppleWorks version 13 or earlier, set up a 
new spreadsheet Put the value "1" in cellAl then 
enter "'+A1"' as the formula in cell Rl Copy B7 from 
CI to DW(the endo/rou) 1). Youtgetamessage that 
"Some cells were lost from Eow 1" Save &ie spread- 
sheet file, then try to reread if. "Getting errors trying 
to read <filename>" wHl result 

ilnother, more insidious error; Start as aboue, but 
copy the formula only to the range CI to CSl !io 
error is mentioned, but0eTmMigStCpJeMmi'lbe 
reread, either 

now copy the formida from cell CI to CRX then 
enter a label in CSl AppteMorks will stop you after 
eight characters, Entering "abcdej^" is tegat bui 
entering "abcde/gh" resufts in a "ceBs tosl'" error 
Howe.ver, in this case there is noprobtem Lsat/ing and 
reioading the file; the label is automatitalfy truncated 
bacfc to an acceptable length. 

Flow manually enter the /brmuia "+CR1" into ceil 
CSl (over the iabel). jlppieHfarfcs giues you an error 
and ignores the entry. But if you blank the entry first 
AppleWorks acceiJ/s the manual entry with no error, 
but uwn't aiioM you to reload the spreadsheet after 
saving it Yet if you blank out cell CSl after the error, 
you can save and recover the resultanl file. 

These anomalies all stem ^m a maximum fimit 
on the number of data bytes that can be contained In 
a single AppleWorks spreadsheet row. This linutisn't 
discussed in ;^pp(e's manuals, though it has been 
mentioned MXipen^ApjtteiAt^istlSBS), p^eSg), 



The bigger problem, however, is that the maximum 
limit for the number of bytes you can enter from the 
keyboard and save to disk is higher than the maxi- 
mum ttmityoucanload. TTiiLs the incredible .sitiiation 
like yours can occur where a spreadsheet yom have 
created can't he reloaded, 

Fortunately, thm is now a faltiy easjf method 
avmlabieia recouer the /i!e. find someone who has 
AppleWorks 2.0 and an Apple Memory Card or the 
equivalent. When used with expanded memory, 
Applei^rks 2.0 allows more data bytes per spread- 
sheet row than earlier versions. It will readily load 
your "damaged" spreadsheet Blank out a cell ortiuo 
in your longest row and resaoe the spreadsheet It 
should now load into an oiderversion ofJ^pteV/brks. 

HeaOze., however, that this ve.ry abS^ Creales a 
new incompaliliiiity—it's possible ta create Appl&- 
Works 2.0 spreadsheets that can't he loaded info 
earlier uersions of the program (or euen Into 2.0 
running on a computer without expemded memory) 
because of too much data in a singie row If you 
share your templates with others this can tiecome 
signi^cant Of course, it also goes urithout saying 
that spreadsheets that use new /eatures of version 
2.0, such as the ability to inciude and -^OR 
inside ^IF statements, won't run on earliii versions. 



i;m^^:'i^0^'^m^leVIor]fsversiQnm:p 
version f b: t was sure &af all my old AppleVfeifes 
spreadsheet files would work with 2.0, however, that 
was not the case. The differences are subtle, but they 
do make a difference in the final spreadsheet The two 
differences that 1 have run into so far are as follows: 



Version l.I 



version 2.8 
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In the first example, the only way to make version 
2.t) respond the same way asTfcrsion li is topuf the 
"4*5" in parentheses, like this: ^IF (Al=(4'5)10). 

In the past I've used a technique based on the 
second example to change ERROR to MA vAere my 
spreadsheet has division by zero, but it no longer 
works. 

I stae would like to know if anyone else discovers 

James RLeth 
Palos Verdes Peninsula, Caiif. 

We checked and found that Af^eWorks versions 
12 and 13 act the same as 11 Jnterestir^gZK^ 
Adoancea YtsiCalc acts Uke AppUmr^'W ^ 
your first example (it reguires parentheses around 
4'5J, but it acts like theearUertxrsions of AppleWorks 
with your second example (it passes through an M 
that is referenced by an 9IF comparison rather than 
ConvertingittoanERROR). 

To make a diuision-!)y-zero show upasM rather 
tiiartEKHOK iryiiiis, where "diiiisor"and "diuidend" 
are cei! re^rences; »|r(divisQr=Q,^Il&,diwdend/ 
divisor). 

Nulls nullified in 2.0 

1 use AppleWorks to report both U.S. currency sums 
and Sterling sums. What 1 previously did was to 
configure two "printers" (both actually the same 



Imagewriter) with different interface card control 
sequences. The control sequences switched the 
imagewriter between the U.S. character set and the 
U.K. character set, which includes the "S." (I'd like to 
see if you can print that in Open-Apple). 

When [ tried to duplicate this configuration with 
AppleWoilis 2.0, I found €at *'feMtiia»ft" flite null 
code, hex $00), which is needed to change character 
sets, can no longer be entered. To get around this 1 
copied the SEQ.PRfile fom my old version of Apple- 
Wtorks tothe2.0disk.This seems to work but I am left 
confused by the whole deal. Why is Apple j^RKJrfng 
functiona% ftom AppleWarks? 

Tony Bond 
HertSj England 

Slow find, fast sort 

We have one He running an expanded version of 
AppieWM-ks ^iteurs-aday. The ippmpWieris dedfcated 
to one data base lile. It is used by non-computer 
people; open-apple-F(ind) is their most important 
tpol. If they have to stare at a blank screen for more 
than a few seconds, they will ignore the file entirely, 
and that would, sooner or later, be disastrous, never 
mind that before implementing the file it took them 
three to ten minutes to dig the inforaiation out of a 
series of card files. They've forgotten all about that 
And since this file will be around 500K before the end 
of 1987, the problem can only getwcrse. 

tjonsequenOy, any speed differences between Apple- 
Works 13 and 2.0, as expanded with Applied Engi- 
neering's desktop expanders, are of great interest to 
us. After a series of tests I've concluded that there are 
significant speed differences. AppleWorks 2.0 is 
about twice as fast at loading and sorting files, 
however, the open-apple-r(ind) command is about 
three times slower on the newer version. 

Tve also concluded that SuperJ^facroltor/cs, doesn't 
sfow anything down in spite of the sii;e of the files it 
adds to AppleWarks. There is, however, a minor bug in 
5uper MacroHfarfcs that prevents one from stopping 
the printer in mid-flight Load the MAirtMEnU program 
and change the 208 in line 18 to 240 (fix courtesy of 
Beagle Bros' excellenttechnical support department). 

And please, no more of this foolishness about 
some cMher program being better than Super Wacro- 
Hbrte. The control-S(ubdirectoiy) macro, which elimi- 
nates the need to type pathnames, is worth twice the 
cost of the program alone: "This new version is a real 
bam-bumer.'Dyit 

WM. Patterson 
Davis Wharf, ^, 

Many unhappy returns 

Since we have an Apple l,aserwriter connected to a 
Mac and an Apple lie with AppleWorks, it is most 
useful for US to be able to tranter AppleWorks word 
processor documents to the Mac for printing on the 
Laser printer. This can be done with the Maclfansfer 
software ftom Southeastern Software (7743 Briarwood 
Drive, new Orleans, LA 70128, 504-246-8438). The 
program costs about $50, requires an Apple lie to 
Imagewriter cable (usually), and uses a Super Serial 
card as a Sending mechanism. AppleWorks files are 
changed to ASCII and sent to the Mac 

Your reference to the August 1985 article about 
formatted Appl^rks filesin response to thef 
1987 letter "AppleWorks vs chemistry" (pge 3.4) 
suggests that you may not be aware that AppleWorks 
2.0 places returns at the end of each line when you 
print a word processor document to "a text (ASCII) 



file on disk." Previous versions didn't do this— they 
put returns only where you had entered them manually. 

MeivinBrubaker 
DQlsburg,Penn. 

You're right I'm becoming disenchanted with the 
disenhancemenis that are turning up in ^pleWdrks 
2.0. This one atone is reason enough to rnafce sure 
you keep a copy of AppteHbrfcs 13 around. As the 
previous letters show, AppleWorks 13 is also handy 
for creating SEG-PR (printer configurationj:ftles0h 
nulls in them and for dcmg faster pnds. 

Inside Applesoft 

1 would like to know if there is any way a user 
program can access the ROM routines in ApplesoB; 
directly, like aCALLorsome otherway 

Kenneth Hoel 
Madison, Ala 

It's both possible and common fOr programmers 
to access theApplesoft RONrouUnes from assembly 
laa^m^S, However, Appie itself doesn't provide, any 
tr^timAm on hoiv to do this, prohably bstaiiSE 
Applesoft was writtenby and licensed from MiaoSoft 

Roger Itegner ft^fisfting, houjeuer, prouides a 
program with its Merlin assembler caUed SOUR- 
CEROKFP that wiR print a disassemfiiy ofJ^plesoft 
Similaiiy, S<: So^uare sells a package that will 
aliow you to generate a source iisttng of Applesoft 
compatible with its assembler. 

Applesoft ROM calls are usuaify made from amper^ 
sand routines, although it is aiso possible to me a 
CALL. For some examples,^ee "/nput absoluteiy 
anything" in our Septernber 1985 issue, pages 65- 
68, and the foiloio-up in/ormation ui the October 
1985 issue, page 74. 

Tlco other more complete sources of Information 
are Assembly Language for the Apfieaoft Pro- 
grammer by CM! fJnfey, Jr. and Roy E. Myers 
f4ddison-}ife5le^ and Ca)lA.F.RLE.Ia Oe^Mi 

Random numl}ers 

The Apple II Reference ManuaJspeaks of a location 
in memory to i*ich 1 is added repeatedly while 
waiting for input from the keyboard The resulting 
number is used as a random number seed for 
programs. Please tell rjie where teis location is and 
bowtouseit 

QlennQolta: 
lifeeatoalB. 

The Appie Monitor ieaues random values in bytes 
78 ml.I9 (HE-UB every time gQH caii.on it for a 
Mgrn^tmi mm: W^S^^^r tfe keystroke, the 
Monitor changes the v^ues stored fc Si«se bytes 
thousands of times a second. The changes stop the 
insta nt the Monitor senses a keystroke. The random- 
ness comes from the impossibSity of confroiiing the 
amount of time between fceysfrofces to the degree 
that uKtuid be necessary tofdi randomness. Try this: 

ifl BET fif : iStI t^r»r)ta»lze vnUm 
2t PRINT "BYTE 7S IS *;PE:EK[7fl] 
30 PRINT "BYTE: 79 15 "jPEEKf??) 
40 GDTO 18 

There are three iijnifations to these random 
fimBa^.mt&mtsorMtim^hmwptmm6^ 

for each new random number pair. Another is that 
the numbers you gel will always be between cind 
255 inclusiue; if what you really want is a number 
between 1 and 10 youH have to do some careful 
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m^ematicai manipulation to comert what you qet 
into what jfou lumt. The third is thatyou can't repeat 
a series of random numbers for lest purposes. 

The good part is that the numbers you get will be 
absoUitdy unpredictable— which is more than can 
be safd for even the best software b^ed random 
mmOi&^^T^ars (fipplmfi's (s tme of fie most, 
t^a^^^y. P^mu^ more on lancfimi tmtAeis, 
set my column inSofUUt,J^ 198*, page 52, and 
the chapter "BandomffunUKf In Don Lancaster's 
Asaemb^ CooUbaokfbr Uie^ple B/Be, pt^ 
345. 

Telling Pascal time 

Where does Pascal maintain the current date? I 
have attempted to control and update the time from 
within my programs and have never completely 
succeeded. I have learned that the date is retained in 
bytes 20 and 21 of block 2 of the disk diFedDiy in a 
compact bit formaL But because under certain 
conditipns I Heep recetvlns the ol4 noiHiptlated 
dEite, I irander wIk&(t it is not also duplicated 

Roger H Eddy 
lEgtMjtjrdttB. 

I bemi tMs one (mr to Dennh wtm. with m 
Ba^iaffl's hefp, came with this: 

Apple's UCSD ftiscai operating systemtce^the 
date in memory as wellas on disk. Tlte date format ts 
the same two-byte format used by ProDOS (Pasc^ 
does not keep track o/ the time}. This format uses 7 
Wts to desfflnate the year, 4 bits to designate the 
month. andSbttsto designate the date for a total of 
16iijts. 31r^i^aie ot]^nlzed (See ffiis: 

Hi hytt Ijw byte 
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.'Is the bytes appear in memory, their order is 
ret.'ersed in typical 6502 fashion. 7b find the date in 
memory, 1 set the date with the Pascal Fll£K then 
popped Into the Ue's monitor and did a memory 
search. The date is usuaUy found in two locations 
with this seaich: the iow^ memoQ) ipcaf^on is 
a^ievs^tel emfram 0ue fmAm vMn 
Oie fUlR program's memorj^ ^ second \s 
the date's actual locafton In fhe i^idgnf p-system 
program. The locattonisdifferentforvairiousversions 
and memory configurations of Apple Pascak 
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lie printer problem$ 

monotyfiomCheckMateand an ImageWriter ptinter. 
J use tlie large memory as a FroDOS W\ disli to 
store, among other things, AppleWarks. Everything 
works fine. 1 often have to reboot with DOS 3.3 to use 
some of my software, and then I reboot with ProDOS. 
A nice feature of the RAM disk software provided by 
QieckMate is that the RAM disk isn't lost during these 
reboots; AppleWorks is slill in memory and worlcsfine 
—except fi)i the prinfing. 

Somehow, K:bootlngMth]X)S3L5 and then FroDOS 
conftises ttie serial ports and produces garbage 
(usuaUy unprintable characters) in place of normal 
printouts. Hitting the RESET key doesn't help nor 
does turning off the piintQ'. Running Hie ti0R IIg 



UdiilyDtsk, which resets the serial potts, usually fixes 
the problem. The most reliable fix, however, is to turn 
thellc power off, but then I lose the HAM disk. Whafs 
happening ^dhcAvcanlfix it? 

5.A.Rlein 
Hadison,1lii!sc. 

TTie Apple ilc keeps some information about its 
serial port settings in the awdiiary memory "screen 
hotes." TTiere's nothing afiout tooting either DOS 5.3 
orftoOOS tfiatchai^es these ualues, so / suspect it's 
one t^your DOS 3.3 programs that is causing ttie 
trduKIe, ni« ^i0Bal solution ^ to simply fix the 
Uatues after rebooHng tuitfi ftoDOS and before 
running AppleV/orits. 

for a fit tie program that shouis you how to figure 
out what the uatues are supposed to be and how to 
reset them, see the JYot/ember JSflS Open-.4ppte, 
pages S£and87. 

Pontrix user group 

1 am the piopammer of Apple fbntrijtand president 
of the Apple Fontrix Club. The club is unaffiliated y th 
Data Ttansforms, publisher of J°bntrix Membership Is 
$30 (tlSienwail) and includes a monthly newsletter, 
a (hanie cat^ taffio fiee Qtaffles &(mi the catalos, 
and njialt^pSfymentsforatvQtaflnesyou submit and 
idiich presold torn ate caiBtag. 

Rod nelsen 
Apple Fontrix Club 
FO Box 29857 
Thornton, CO 80229-0857 
{303)45i7577 

UniDisk manual ejed 

TS)UcangKta3.5(IisKoutofthe drive with the power 
tuitied cff (see "Hgs ^estions and obsentations", 
January 19&!, page 2J94). IJbein || itn ^ocess hole 
drecdy below the ^i&i txd&aL l^ie a 
sb-aighten it and piessttfeio tti^Me and tte disk 
yMh&^mied. 

Ronald W Jones 

Well yes, but it takes a good deal of pressure, 
aboid an inch of paper dip, and feels a bit like you 
are bending something you shouldn't. In Apple 5.5 
drives the hole goes right through the q/ect itutton. 

All chips not off same block 

We have a very active leer group here in Dhahran 
(about 300 members, mostly employees of ARAMCO) 
and are well supported by the local Apple dealer, 
more so than any dealer 1 dealt with in the states. 1 
now have an Apple llgs, (one of two 1 know of in the 
Kingdom) with an AE gsRAM card. Even hers 1 have 
managed to kxate a couple of pieces of llgs software, 
t also have AppleSlibrks 2.0 and the new Applied 
&iglneaing ^pleuorks expando'. 1 am wattiag for 
Fhipofnt2.0, which I ordered a couple of weeks ago. A 
Pinpoint product 1 did receive, and that works very 
well, is foint'to-PoInt This communications package 
works with the hullt-to slqt'2 pcwton the Ogs wilh no 
problems, 

1 did have one problem in using the slot-2 port witli 
my older Apple modem — Ending a cable that would 
work. It Is way too early for the Apple dealer over here 
to begin TBceivingfliis accessoi^JiutlMicaiBe 
thitx^fbr me W an dtd-?1at to Ir^ieM^ U 
cable that has a 9-pin connector on the Mac end and 
the small 8-pin connector on the otho; ljust turned it 
annuidanditworicsline. 



rve had one other piuldesi t want to ptdnt out I 

bought my gsRAM card with a meg on board, as I had 
two sets of 256K at home to bring it up to 15 meg. 
After installing those chips, the machine kept crashing. 
So I removed my own chips and everything was OR, 
Then I removed 512R worth of chips fiom a RAMWorks 
board (th^ weie the same brand and number as the 
chips on the gsRAN board) and installed them on the 
gsRAM board. This worked. I then Traced tlie after- 
maritet chips in theRAMWorks card. This worked, tbo. 

What it boils down to is that you may be money 
ahead buying these boards, especially the complex 
ones, with the chips supplied by the manufecturer. I 
would have hated to have bought the gsRAM tx>ard 
with only 256K on it and them hiqr 125 meg or<£l^ 
that wouldn't work. 

daudeAMlen 

Dhahran, Saudi Arabia 

hwe had other reports that not just anyJ256K 
chip wHl wori; on cards Bat reside in the Bgs 
memory expar^sion sSot, butwehiaien'tyethearda 
good e^lanation of u^iaf the difference is. Untcl 
someone who knows explains it to alt of us, I'd 
recommend that exba chips /or /igs cards be pur- 
dtasedmtiftousiji. 

Time to k)ok in the toolbox 

Ihavea couple of programs that run under ProDOS 
111 but that won't run under FroDOS 12. In order to 
allow these programs to use the llgs clock ! vmte a 
special dock driver for FroDOS UL I thought some of 
your readers might be interested in the heart of this 
driver, which demonstrates how to make a lixdbcK 
call on the Apple llgs. It goes fike this: 
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Wfilliam A Coleman 
5904 MW 49th St 

Oklahoma<%OK73122. 

I'm indudmgifim address so anyone who wants 
your whoie dock drfijer can contact you. tts been 
suggested thai Iinctude an address with every letter 
I print but I don't u?ant to discourage anj/one 
wrfting and / don't want to cut myse^ out c^good 
"message threads "—would printing euerj^ne's 
address ftaue either of those effedsl 

it. might be good to remind everyone that our 
August 1986 issue went, info uihaf manjf of you 
lirt0ii^iaas^excri«datiQgctetaA<m6^ 



TtoL3,tfe3 



language. Coleman's program uses a number of 
commands that luili be new to 6502 assembly 
language programmers— gou rtay flod Oiatksue's 
informaSon helpful 

For now, let's just say that the /irsf three lines of 
Ooteman's roaHne are the stantfani way to go 
■^SOZ msar to 15M»1ra)£((r aWff^ 
lines are the standard way to go bade. 

TTie gerierat /brmat of a f/gs tooffiox call Is to push 
some bytes on the stxk for any in/omiatrofi the toot 
will return, then push some bytes on the stack with 
any data, the tool needs, then load K with the tool 
number and, fimdty, JSL (jump to subroutine, long) 
to theUgstool locator. Mch is always at byte $0000 
fnbank $E1 J^the tool caH my data passed to the 
tool u>W turn been stripped ojf the stadkmi fie 
c^bigprogtm can just start fKOmg olf results. M 
tOoUxnrcals, !nddenfal!(f;, must be made from fudl 
l&bitmode. 

In this aiample, Coteman uses the PEA instruction 
to push eight bytes on the stack for information thai 
vM be returned by the toot PEA pushes the two 
bytes thatfollQw the command onto thestsaSiTiml 
to M* qf it as 3 ')9ush ten^e(^&'' aa)!jmis|ii liut 
tlMt^a^ iamdf^ee new mmitmik for ptemry 
ateob^> Indiied. and relatiue addresses onto the 
stacfcidtfioutdfeturWng the contents of any registers, 

M ffie programs i'ue seen so far use PEA $0000 to 
reserve stack space for the data a toot will return On 
the other hand. PHA in 16-tM mode also puts two 
bges on thestatX but takes vponly one byte in the 
j!ro^fj(W^ cdn^jfflied ^ flSH's ftiw; tip ioBsn't 
smii^ be any reason why the reserved spam has 
t6 fwMd zeros. Can anyone enlighten us as tfS iohy 
people are using PEA rather than PHA? 

The number of the tool t/iat reads the cloc*; and 
returns eight hex bytes on the stack is $0D05. 
Apple's mzmais vm^ W& iodl J^eadliitiellex. If a 



tfKB ||^ ,(||^ 4ie^s||Ei^ IIk off the 

$(sKi:fb iiEs atfer-^ iRMutes, hour, year, 
da9<p^i@^#&»£SCI:#onCti iOto W, onesarbs^ 
byte, anddsy-of-weekil to 7, 1-Sumiay). 

To enter Coleman's program from the ligs Monitor, 
use a CALL -151 in the usual way from jlppleso/t 
then enter and press return to get into Uls l^ 
jiflnMssemtiter. Tt> enter thepstltnsf^ the^ogism. 

^ 'wot me 30© imm fmmmoisf 

tefeere to^aretthepm^mmHaasmtiles It. After 
that, simply enter a lilanfc^tace and the assembly 
language command— OteproffSmuM be sl/afed In 

successive bytes. 

7b get out of the Mini-Assembter, press return on a 
blank line. If you try to use 500L to list the program, 
it won't took right. Thfe ^ b^smse the program is 
iKins listed as if QiQ pm^min ttm mmin^ in &M 
fiiaiemStertlmWfmW^^ IBOoa^ilMffkM^ 
enter the following bit (lf ma0i '^e b=m O')r. Ws 
important that you use lotoer-caseFefters. lb go bacfr 
to 8-blt listings use, "l=e I=m l=x". 

TO run the program, try Ihh ' 300Q =T 530.537" 
fthe spaces are important!!). 7Jiis will run the program, 
print the current time an the screen, using a spcc/ai 
J7gs command f=r), and shou; you the contents of 
bytes 330 to 337. TTiese bifii^ «re where Oiieman's 
program stores the stacfr ii^/brmatfon reitumed ^ 
the tool can. Convert the hex bytes to dedmai and 
youshauld be able to quickly grasp how they relate 
to the lime shown on the screen. 

I haven't yet had much experience with the ligs 
toolbox, but Coleman's program prompted me to try 
a few things, mduding reading apage or tufo <4the. 



developer draft of^ple's toolbox reference manual 
fffouemberS, 1986 uersionl./hppc the documenlation 
on ReadTlmeHex isn't an indication of the quality of 
the whole manual TTiere are two significant mistates 
on the page about this command. 7he first Is that it 
JShows ten J^tes l)dr;g pushed on (he stat^ rather 
ttait ^g)A (§te iM tia> are c^d 'bt/ffe^e"— 
what buffer?). The second is that it says the day-of- 
week Is reUmed as a number betu^een and 6, with 
Ijeing Sunday. Ws readly 1 to 7, mOt 1 being 
Sufjday. 

There 's another /Jgs time tool that returns the time 
in ASCII rather titan in hex. There's aiso a mistafce in 
the documet^tion about K-^tt&idEcates you should 
push a tworbj^ address on Ae ^itd^ pointir^ to 

^ the program reqi^ I address, 
ifeife's a (Ittfe program flat iMts BiiSiikA 
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08/0301; rA 00 00 PtP- 18000 
00/8307: F1 30 03 PES 58338 

ee/essR: rd 83 er ldx wta 
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Ehojld put tins. 



90/8311: 3'B 
00/0312: FB 
00/^13: 60 



SEC 
XCE 
RTS 



Srblt uode 



This too! doesn't return any data (m the stack, so 
after the JSL there's no pulling to do. The pushing 
that's done in this program passes 'information that 
the tool will use (where to place the ASCII string). Ttt 
run this program and see the resH^^^^WQd^t 
530M3"ii^r^nt^(ngQkeptog^ 

An^featmof^mSiitntie tociFls^the time 
isMamed In u^ataxrformat has been selected by 
ifie user. TTiree date formats (mm/dd/yy, dd/mm/ 
yy, yy/mm/dd) and two time formats (AM/PM. 24- 
hourj are araiiabie on the Ilgs. The user selects his or 
her preferred format with the control panel This is 
the tool to use if you want to display the time w'dhin 
apFosram. 

Odd bank out 

Programmers should know that if they are printing 
MftaPR*! or PR*211idr output cat! he^bted if the 



$32) not only affects screoi output Ita^saambies 
the data going out the port 1 worit 6a: a flrm Hiatuses 
a form of Braille desktop publishing (wc send data 
disks to a Braille printing house that has an Apple lie 
plugged into a $50,000 machine that produces metal 
plates for Braille embossing). Our sofhraie oocaaionally 
had the inverse flag on. The result was over $6,000 
wgith of Siailk wyth all the k^ words g^arbled. 
SonidKta^llKse Htlfebugs canget quiteo^n^ 
Our flmi sells a DOS 55 word processmg system 
fbridsually impaired Apple 11 users. I ttiou^ ft would 
be interesting to modiiy the program to malte use of 
the additional 128K found in the Apple Ilgs. My task 
was to load and save blocks of data to memory banks 
$E0 and $E1 ftom an assembly-language memoiy- 
management piograni running in mQ^sy^mmm^ 

Ttie flM IMig I found was thatit was nece^aty to 

set the SHADOW re^'ster of the Ilgs to $1C. This 
prevents the Ilgs from automatically cof^ng whafs 
written in tanks $00 and $01 into banks $EOand $E1 
in the range M memory that i was interested In using 
($4000*BFOO).TftHi do fliis ^poMng^tC iatobylE 



next 1 discovered that memory management was 
much more complicated than described in the Apple 
ligs technical manual. With the 65816 in full native 
mode, the K register {program bank, i.e. where is the 
program running) and the B register (databank, Le. 
wtilch bank is bd[t]^ read or writteaitD] cootol ti^ 
b^k^ % is iMiig willi. BiitVfhen die 'rS 
emulating an Apple lie or lie, fte soft switches RAMRD 
and l?AMW?cr are used to control tanks, When a 
program is running in main memory, both switches 
are oif, so the Apple is reading and writing to main 
memory When a program is running in auxiliary 
memory, both switches are on and the Apple is 
reading and writing to auxiliary memory 

I disowered that If Hie soft 5witi±es are on ndien 
ybu tise^'A()pIeI^ftinkffi« ttod& It^^^ 
and K re^sters act as if Hi^wete odd, even though 
th^ are even. In particular, if a program is executing 
in auxiliary memory and then switches to native 
mode, the B and K registers both hold zeros. However, 
your propam will read and write to banks $01 and 
$E1 because the soft switches make B and K "act" 
odd. 

r^pio^cam switches into nat^ mode, s^tb& B 



alrea(^niakingthemappeartabe),tutmttie|r^Ib|]f 
memory soft switches olT, and then accesses any jpart 
of Ilgs memory it wants to using the "long" instruction 
mode. After the read/write operation is over, eveiyflnng 
is undone in reverse order turn auxiliary memory soft 
switches on, set the B and K registers to $00, go back 
to emulation mode. Finally, the program returns 



tIieKit^I^i@«:q)ta "longjump."Iiiseittojunipto 
the nextlQslJw^ori using the bank numt)er 00 or 01 
as appMpiate. Here ^the code I used: 



This routing bosbbsbs all Il5^ iwitw^ fiSSf^flUX bb«i> 
This routine MET rCn In fllK mem. the caUing 
program mugtaet the SHADOW registar at ICeSS to 
SIC so that the Ilgs uon't ouerurlts Uie maniDry 
area f rtm MBBB to STFT In banks IE8 and Kl. 

CLC 

XCE Go to native mode. 

JUL **4 Jump long to next instroctiQn--usB 191 as 
ths bank nu^r. This sats K to Ul. 

LDfl BE01 

m 

srn fceez 
STfl torn 

REP tt» 



Set B to SBl. 

Turn off niBffl soft Bwitches. 
Full IG-bit siDiie. Don't do this until 
you've changad tha soft suitchas. 



—-[load or eaue tn banl< K.i or lEl gciei hara.) 

SEP 038 ia5l< Xa S-blt BOdB. 

51fl 

STfl Turn flUX nieir sof^ switches on igain, 

JML Jump long to n*xt instruction-'use 100 as 

thB Ml* riUBber, This ssts K: to SBB. 

LOfi asaa 

PHH 

PLB Set B back to J00. 

SEC 

XCE Back to emulation imda. 

Anjn^ thatrs the first piopnn I mkn u^g fiie 
flew op codes in the Apple Hgs. I toiow that I am 
certainly not "playing by the rules". The purpose of 
this hick is to give a program some exfra power while 
you re-tool your programming skills to make full use 

David HolladE^ 
E5aised Dot Computing 
Madison, Wise 
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howtouseOieng^MefmyNsnagerliosaasiie the 
meimiy you are using in banks $B0 and $E1 so a 

desfc accessofy or something doesn't ouemirite 
what you've stored there. I've spent a couple of 
hours tfying to do this with the Wgs Mini-Assembler 
but haven't yet pgured out how to ta!k the Memory 
Manager into giwing me a "UseriD." Thai's supposed 
to hsppm Wlt^ Kse 3 tool cailed "MMSiaiiVp," 
tof&mrysi^pSBi&sitpf^rm is sn^ijxsed bi caii 
as one of its flist adtons. Ail (he Nemoify Manner 
win give me is an Inualid IfeeriD error" Wauc any of 
you ligs wiiards figured out how to do this yet? Rich 
WiUiams, are you listening? Don't send me any 
workshop-ioader-macro baioney— first 1 want to 
know how to do'UunskrProDOS 8 (orevmDOSS^) 
um the md-Assenaier, JTiat makes & more ttke an 
adi'enfuregame. 

Making connections 

tieve's a source for the hardrto-fiad DB-ID plugs 
and ^cks used on Apple Sma^iOrt dei^c^ SDtUl 
S125 floppy disk drives. One stnaD pB^km is Qiat 
ttiey require a minimum order of live and Hay don't 
actually stock ttie item, but at least they can get them 
for you. The company is Stout Cables InC/F.O. Box 76, 
Se*iGt3€y,FAia43412-7a-3900. jefli^Young 

Wbods!de,M.Y 

/called Stout and ttey canalso jmwfde (he J^pin 
connedor needed to loM RGB caMe and the 
mate MIIiIDir^ne^df»&M^thltpb^i0atke 
ffgsseriai ports. 

jlnother source for 15- and 19-pin connectors is 
JDR Microdcuices, 110 finouiJes Dr, Los Gatos, CA 
95030 800'53&-Sm 

No endorsement 

On 3.8 the Februaij 1987 issue of Open- 
Afpteym mention the program fingertips as allowing 
rudimentajy use of a modem (see "Communications 
sofhiEiie"}, 1 vm unable to get ihis Ceatuie of the 
piograialawoii. iHnir^%f&ff^^ 
two separate occasions but did not leOslK a tep^ 
Since ttie rest of the program Isn't worflt nadi I 
tossed it in the drawer andamcontmtitignQiseifwittl 
spreading the word. 

When you mendon a product in your publication it 
can tie intetpieted as an endoisement 1 thought you 
might lilie to teiow wtiat Mnd erf trains you m 
endorsing, 

Wiiliam G, Ingersoll 
Ft flfeilton Beach, ria, 

Oddly enough if you go 6acfc and read that letter 
and our answer again youH see that wtat we were 
reat(y tiyinQ to do was atjotd endorsing anj^ sped/ic 
ptti&t Dennte and I want to make it clear that we 
mmf^ <ascQr0(sed the plethora of Apple U 
pmMsmanysiie eLse. iJt^ftumtely, uie are also 
fn a posttton where we haue to msumr questkm 
regardlngtheseproducts. 

/I good chunk of our mail isfrompeopte mhomant 
to know dbout the features of a spedflc product or 
about the products available to solve a specific 
profiiem. life can handie these one of tux) ways; 
smply tell you we don't have my direct experience 
lei^ apj^uct jnd make m qffer of informaUqn or 



do far Qi?m0^--ie^ adoertislRS and retiileu^ 



^HMi^isi^jotoasierg^iDii^ logon 
to £iul{^n bd&ds^ and caH or unite mamt/acturers. 
Vto haue one adcfiHonal source of fn/brmation that 
most jseople don't fmue—letters from people like 
you who ffve us a feel for how much, you like or 
disfiice specf/icpiodiKJslandtfie'j%^eiirgljfoudonl 
like this one). 

We want to mils it clear that you should never 
take the jnm mii^ of a pjoi\tia, fim !n C^peo' 
^igileas ancndbrsement ^3tte df itsl^ artduses 
aproduct loeWsai^ so. £oen then, the fad that one of 
us tikes and uses a product doesn't even mean that 
the other of us does, much less that you will 
Conversely, I've disliked products that readeis hate 
thought very highly of for example, see "SifierGalc 
Ja defended" in July 1986. page 2,45, 

The ghost in the machine 

When an ^ple II reads a tact Be, samehoiizontal 
lines, ratagife a osititdetei: long, flickcr lri ^nMy 
Msbton along ti^e left marghl of the saeerL Is this a 
cottblvance to Signal that somelhittg is happening or 
is it just OIK oT those IftUe Idlo^crades of Ihe 
machine? ■ 

Odess^Tesas 

tt a t(Ni^sti»g. Con^MIM^^&oS doesn't 
know a disk drive from aputtei. Wm^imdAtBt 
fUe, alt Api^esoft sees ts a FfUtfT SBtfemoit ffiSt 
begins u^ifh a mlly control-D and an IUPVT statem ent. 
In response to l^iPUT, jlppieso/l caits a tuilf-in 
routine in the Monitor TTiat routine, as aiuiays, puts a 
cureoron the screen and jumps to the current input 
routine. Unde DOS always has himself hooked in 
there. Because of |(our controi-p command he 
lmauiS:^wmtU>mdif^^ $oMpulaaUnefmm 
UKfUeinthe Input bufferandpwses oantrol i>ack to 
the Nonitor. The Monitor remoucs the cursor /torn 
the SCTeen and passes control bacfc to ylppieso^. 

AH this tiappens so fast that the cursor doesn't 
appear on the screen long enough for the Apple II 
video drcuitry to scan it in its entirety. Usually only 
one line of the cursor makes if to the screen before 
the Wor^itCfT tfffloues it. That's uO^you are seeing. 
fdMmUi^^^^itaaanWk^^im^ raSterihart a 
contrtpands. ' 



I thought your readers might be interested in this: 
On the lIgs, location 49206 may be poked to change 
s^tem speed.FoMeb]a4 fin- slowor at^ltr^ 

^WyKFox 
tfiekstHte^M 

ntaSirBsnyi lhais the llgs coifigwratkm register 
you^re plaj^'ng wf^Mm^^^ a few other bUs of 
{ri^nnation j^udO^IUMb^iteige by acddent A 



iA REH siou doun (ir I<=>127 Otan al raadu sleul 
U I-PEEKCBZW)': IF I>127 THEN PDKE 49286,1-128 

le UtJt spea! up (IF I>=12S xhm mlrwdy faft] 
11 l-PEEKl'fKBE) : IF I<12S THEN PEffi 49ZK.iT+12B 

If p>tt do thisfiom twbk a piqgim doni forget 
to put the speed tiadc Where you found U when you 

quit 

FIDdle sticks 

hycm Vmmiiei 1986 issue, page 87, you gave a 
procedulB for u^g ati EXEC file to automate FID for 



tmm.i 

(135 seidtora.j^MB^gess). Then the proceduiB got 
as lar as the Brst**)f affer the Tl" for no prompts and 
had to be completed manually 

With the large file deleted the EXEX: file would work. 
Is there any other way to do it? 

I've had houble sorting zip codes with the Apple- 
Works data base because my file Includes a mix of 5- 
(Hgjt and 9-fligitzlp ccHdes, I'v^beenusiosihe fonoat 
9ES®9.^^ for §^ sip etxfes. ftrefudug the 
dedeciil point gets ilte ^ codes arranged to Hie 
corr^/o^E£ 

llotQrPMza 
Caniarlilb,CdI£ 

you're right. The EXEC fUe seems to die an umatur^ 
death, wfi^ a l^fga file is copied, fiobo^ here 
knows idy <ir hm to mM it Does anyom ad 
there know? 

The mi«ed 5-digit/3<(igIf zip code problem is even 
easier than that to solve. TSke out your decimal 
points. Justsort the lip codes alphabeticalbf rather 
than lamericatlij and they'll come out in the order 
you want Aiphabetkat sorts are also faster thm 
kimeiicatsofts (ttMti^fjpfeiibtfes, m^m}). 

NO BUFFERS help I 

AcommentonJohn Slilar's question in the Felauary 

1887 Qpm^ij^\'(^SiJ!)4av!^m9e^^ 
CWtCnmrtHg uhtittProDt^, fetioSOJfBtS ^SiHIL- 
ABLE message occurs after I have pressed contiol-C 
to escape from a long Off listing Mthout QUE 
controK simply aborts the Temainder of the listing 
except for the free space information. With QPLE, 
which (usually) intercepts the control-C, the listing is 
immediately and completely ended and control is 
returned to the keytuard Unfortunate!): this sidesteps 
Basiosystem's normal cleanup at llie end of the cM' 
command, which includes freeing the CATALOG 
buffer. 

Simply issuing a CLOSE command with no parame- 
ters Is suificient to solve this problem and get rid of 
ttie no BUFFERS AVAILABLE error. It is often quicker 
to do this than to wait for the end of a long CAT listing. 
If you are lucky, Basicsystem will see the conhol-C 
before &W and ttie normal cleanup will occur. The 
giiyieaM^is iidiettief or not Ok tee space oifotmatfon 

The "Applescrft onUPiE call" letter in the same 
issue (page 3.6) has one small problem. The pro-am 
doesn't reset the default slot and drive. This can be a 
problem if you are working without a prefix to force 
BasicsjBtem to remember the last used drive, as 
under DOS 3.3. The cure is to PEEK the contents of 
$BC3C-BKD (48700-48701), the default slot and 
diivB in the Basicsystem global pa^, and lestoit 
thetn ettter truing any PREFiXcommaridsfhat donge 
the defaults. 

A comment on the llgs keyboard. My first impres- 
sions were a bit doubtfiil, but I am rapidly growing to 
like this keyboard a lot However, this is my first letter 
since buying the llgs, and 1 have Just realised the 
consequences of moving the solid-apple (option} key 
to the left of the open-apple key— no more sln^e 
handed kige cursor movements in AppIeWsrks oa^ 
Apple WriteA I had not teah'sed M atrtsmatfc 
skipping a word at a time u^ng the solid-apple and 
arrow keiyshadbecome until] sUirted pladngnumer- 
CHis liackslash characters into this letter. 

Peter Watson 

^mtottb^vic 

. j1slund«!Sfamfftifou(EK)Klda^tta(fte(ftese 
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to Kline's VOUJME.lWGlpwgams 

IS DS^'CEKt'MTW) : DD»PEEK(4B7ei) 

9e PSINT WrPREFIX /' ; 

15 POKE WW.OS : PDKE «791,DD 

Une 90 in mine's ori^nal program Es redundant 

owROriSett £|f #le%e i^im. IM^ man^people 
(font tnow ttey can get Baslc.system to liefiave 
more nte DOS 3^ by voiding the current prefix with 
a "FRERX/" command (the slash Is impoHant). After 
tills command Basicsystem ioofcs fn the'last drive 
accessed for everything just as DOS 5.3 does. 

I agree with yourcomments on the Ilgs keyboard. 
Things could have been a lot ucrse, however. The 
Uqs keyboard is a result of delicate compromises 
between the Apple II and Macintosh keyboaiiK lite 
nmetaiiioaRicJomesuiit^^ 
ffiKMosN corr^H^ liTdfe J^acfKCos^ ustts got 
(hefr tradftfonai position for the sofid-appfe (option) 
key, Apple II users got traditional placement for 
everything else of ipnportance, including the arrotu 
keys, which have a different arrangement on the 
Mac-Plus. TTiis "single keytxiard " strategy wUl be 
very important to // users in ttte future, as any third- 
party keytioaTdsorother"tie^iopbmdei^Ees"(baT 
codereac^jojjjsttdt^ ttacj!t»ti^iittfJ^o^^^#^ 
oped /br tfte ooipotatis MIcAvM tuoritf fie 
usable In the csoOs^gtNndttsfaiafist^fiiileif ii»r(d as 
well. 
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NO BUFFERS help II 

Here is another reason for the flO EKJITERS AtAIL- 

IiadttteseiiKpiiGd^wfftapuJandliamtr^ 

iSfien installed, QPi£ marks pages $8A to $99 as 
busy in the FroDOS bit map, Ttie problem occurs 
when another prograiTi, usually on exit, frees up 
pages it has obtained through JSR QETBUrR by 
calling JSR FKEEBUFR Among other things, calling 
FREEBUFR frees up all buffer pages by moving fflMEM 

^DOS is locked out of its cwn bufler aiea Because 
of this problem, 1 hare mmoved Ihe routines for 
marking the bit nm^ tarn all of tqy boant^oui 
utilities, 

QeotgeWHeman 

Reston,\^, 

jfof marking the bit map doesn 't soJue the funda- 
mental problem here. When your second program 
cafls mmUJFR to release the memory it has obtained, 
this call aiso frees the memory GFLE has obtained. 
^ that point in time QPl£ vMl stSl be in use and 

nmkeise^Um^iiBmii^PmDOSusesaflle 
bi/^rttiMctiawtttB am ata me system uM 

come down in flames. 

The fundamental problem is tWXliVFR ItsOf. ft 
prouides no way to selectiwiy deallocate a buffer. It 
deallocates all bikers, or. more specifically, a/( 
buffers up to a single scledaife point 

/4nj/ program t^c^iTOBt/fRisadai^rtoail 
peace4ovingpi^^f^mpr^(emdantaa^iikr 
uOat the oome^maeswtt be for other prc^ms 
that haue csSed deism TTie consegnence wHl 
always be that other programs will be overwritten 
and will cease to function. The oirig safe uaqi to 
deallocate buffers is to salt tto HWr Id i«* 
execute Bask^/siem. 

For the leooni toatkxate a buffer simply place the 
numtercif memoof pagBii^u de$ire In the m3imu- 
is^miMsGiSE^mmiSf^ tmm& occurs 

dear, jpi have best aUtxatsd a tafior mi &a 

accumulator will hold the high byte ^ Ws a^ess 
(the low byte is always zero). 

You can defend yourself from the warmongers 
irfio call FREEBUFKby immediately storing the high 
byte of your buffer minus 4 at $BEFB. The FEEEBUfR 
routing i/ catted will then unulttinglj) destrpt/ oidy 
buffers it has Mocated a^er yours. Some people 
thte fctfiitfi ^CTHiBt^manjpufafiigjasratfa^ca^ 
c^fW^IBPRiMiiiobadotmseqimcesfbroliars. 
$BEFB can onlyprotettUiose who asked for a buffer 
befoteyou did, howeuGT—U an never both release 
your buferandpnolecf ttose utoasted JbralwffEr 
afteryou. 

For more on how to (itie togeOier wiOi other 
programs in peatx, see the June DOSteik, "A 
Tm Command for PmDOS." in Sofbdb paQt iS7. 
^pie's FroDOS Technical Ifote *9 ma^ also 2ie 
tv&lpfui, butUsuffersfromOiedda^OatitcK^iier 
pmgimuM^for9bt4fab^morifiieryiM^ 

Memory goichall 

Last montfi you published my letter (page 316) 
saying tJiat I prefer the standard-slot type of RAMdisk 
to the aijx-slot type, of RAMdisk because I can load the 
iWldisk with piograms, boot another dish {ewen 



fbom a different operating system), and then lalxr 
reboot tern the RAtMdisk without any pnAiems. 

I have to take it back. I've been noticing that every 
once in awhile 1 would try to reboot the RAMdisk but 
get an LTIABLE TO START UP FROM MEMOKIT CARDC 
error. I'd catalog the <M and Old tbat alt c|ii9 
work flies had vaMied^ I waspopteiedi^Cb^^ffl^ 
consulted a knoi^edgeat)le colleague. lie pointed 
out that the Apple Memory bcpanslon Card {one rtf 
the standard-slot memory boards) uses screenholes 
in the Apple memory to keep track of the status of the 
KAMdish, If a screenhole gets clobbeted the RAM cBsh 
loses its mind and decides to start all over again. I 
had been tiying to run a variefy of programs in my 
Apple, including copyprotected g/mes, some of 
vAiich piobabty tcaK; ncit One about preserving 
saKsenbolevBlu«& 

I sti^iedt tiat flK otfier numbered^ moncny 
boards ^IST Sprintdisk and Applied Engineering 
RAMF^dDrl also keep important RAMdisk status 
information in the precarious screenhole locations, 
though I don't know for sure. I still use my RAM disk, 
but now I'm very very caiefiil about what other 
programs. I run If I eJipect the RAMdsk contents to 
remain inlBcL 

FtiHTbfSt^sm 
FofQandrQie. 

R/Vfdisks have aiiua^s been somewhat fragile 
tre^mes. fiut at (east yfsu can reboot pom the 
strntOarMottoittf canf. Ipebiied ontlssemQRtfi 
ttetufou mi i«bo0t Hitoiit ^tb^fiag Aepes on 

fmimamtmSSM^tlaf^lsta^ios^s^ 

Mee kingdom you have here 

I'm a new "Apple" owner (I bougid a Laser 128 
lather tlmtheiBalthingJ'raii0tinilDGoni|iuter& I 
iimedpas^sm^i^ a Qgfenc 1302 in 1961: be 
laipnBB wsiUjQ^tfe taiehad up to fiiiroon^ 
ters in the house at one time and usually I use (be 
IBM<Ione in my study tlowever, since 1 bou^^ 
Laser for my son, the IBM-done sits with cold it^ 
and my son complains rightly that I'm luggiflg Ms 
computer. I can't stay away from iti 

For years I refiised to buy an Apple becaiee it 
looked lilie a ilpoff— they WBie sdu^ pticed hi^KT 
flian they iiMe vicnlta. Bowwb; bera^ 
library of Apple educational programs, my son's 
reluctance to succeed in school, and thte kwr price of 
the Laser 128, 1 could refuse no longer. 

I've discovered that the graphics <ife. 1ms than great; 
even a $50 11-99 could outdo an Apple. The sound is 
embarrassing to anyone who owned a Tl, an Atari, or 
CDDunode Door 64. iUso, It's sort of ugty Inside, with 
aaeea memoty stuck in tx middle of Ms^ and 
8banfl^lwgBteone(flheokle8tD(^a!Dund.&M;... 
IkHettl 

K}!ascIass.That class isn'tinheientln Ihe ardiiliec- 
hire of the machine; it has something to do with the 
users and tiie programmers and the companies that 
support it The quality of the programming exreeds 
that of any of the other small PC's. The range and 
btcadth of the available documentation astounds 
me. The sottwaie, like the/fuitisaiteword processo: 
rmiain8,isfQ!l 

iaiB0|fl»^ a i 4 ll|i e 1iigi|iB>adtairt 
8t^ hare tilass. b Gnt as ny nest Se^gsot 
used to say, Tou gt^ shine like atflnnoiidiDagaat's 
(anatomical expletive deleted)." 

Dave ^etzer 
Lucasville,Ohio 



